home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 21 / amnix111 / amnix.docs < prev    next >
Text File  |  1994-01-27  |  14KB  |  293 lines
  1.  
  2. ATTENTION...  THIS IS  A DEMO  VERSION OF  A NEW  PROGRAM CALLED 
  3. Am_Nix. IT  IS *NOT* PUBLIC  DOMAIN. HOWEVER, THIS  SPECIAL DEMO 
  4. VERSION (SERIAL #1002) MAY BE FREELY DISTRIBUTED TO ANY BULLETIN 
  5. BOARD SYSTEM  AND/OR NETWORK  SERVICE (PEOPLE-LINK,  GENIE, ETC) 
  6. PROVIDED THAT SUCH SERVICES  DO *NOT* ATTEMPT TO CLAIM ANY LEGAL 
  7. RIGHT OR TITLE   TO  THE  UPLOADED  FILES.   ADDITIONALLY,   ALL
  8. FILES CONTAINED IN THE ARCHIVE MUST  REMAIN  INTACT.  I'D   ALSO
  9. LIKE TO REQUEST THAT  SYSOPS  AND NETWORK  FORUM  ADMINISTRATORS
  10. NOT ALLOW  ANY VERSION   TO  BE   POSTED   OTHER   THAN THE  ONE
  11. CONTAINED  IN  THIS  ARCHIVE.  THE  REGULAR  FULLY   FUNCTIONING
  12. VERSION OF Am_Nix SHOULD *NEVER*  APPEAR  ON ANY  BBS OR NETWORK
  13. SERVICE. THANK YOU.
  14.  
  15.  
  16.  
  17.                            Am_Nix
  18.                    Original  Version 1.00
  19.                   Dated   October 21, 1988
  20.                        Copyright 1988
  21.  
  22.  
  23.  
  24.        Announcing Am_Nix  1.00... an  automated City/BBS  Dialer 
  25. system for Telenet's PC-Pursuit.   While this is by no means the 
  26. final version and there  are many improvements still to be made, 
  27. I  have decided  to release  Version 1.00  because of  the great 
  28. demand  for  a product  of  this  type.  Also, while  there  are 
  29. probably a few "bugs"  (gasp!) within the code, two BETA testers 
  30. and  I myself  have  been using  Am_Nix  with a  good degree  of 
  31. success.
  32.  
  33.  
  34.  
  35.    You'll find these files in the archive:
  36.  
  37.         1.  amnix.docs      this file
  38.  
  39.         2.  amnix.config    sample of file to enter
  40.                             *your* PCP User ID and
  41.                             password
  42.  
  43.         3.  amnix.cities    contains poop about all
  44.                             the outdial cities currently
  45.                             served by PCP.
  46.  
  47.         4.  AZPHO.0         sample of file to enter
  48.                             the name & phone number
  49.                             of BBS's you wish to call in
  50.                             various cities.  Name is always
  51.                             city code with a '.0' appended
  52.  
  53.         5. amnix            the run file for Am_Nix 1.00.
  54.  
  55.         6. readme_1.1       An update to this file for
  56.                             version 1.10.
  57.  
  58.  
  59.        This version  of Am_Nix does  not have any  provision for 
  60. making  the actual  connection to  the local  T-NET pad  (future 
  61. versions  will).  Therefore,  before  running Am_Nix,  use  your 
  62. favorite terminal program to make the connection.  Connect at 8-
  63. N-1; The hunt/confirm sequence is <CR>  D <CR> at 1200 baud or @ 
  64. D  <CR>  at 2400  baud.   Because  you'll  be  exiting from  the 
  65. terminal program  in order to  run Am_Nix (Am_Nix 1.00  does NOT 
  66. multitask), your modem must be set for continuous DTR. Otherwise 
  67. it will  drop carrier  and hang-up the  line before you  can get 
  68. Am_Nix  started.   Also, some  terminal programs  will send  the 
  69. hang-up command  to the  modem before  exiting (Online  2.00 has 
  70. this ugly habit).  So, if  your modem refuses to keep carrier up 
  71. after you  exit your  terminal program,  check your  modem's DTR 
  72. setting and also your terminal program's options.
  73.  
  74.       This version runs only from  the CLI. So.... after putting 
  75. all the above files in one directory, CD to that directory. Then 
  76. (assuming  you   have  already  connected  to   your  local  pad 
  77. correctly), enter AMNIX as the command.  A couple of gadgets are 
  78. non-functional in this release. They are Switch Sort and Add New 
  79. Entry.  Also, there  are some  invisible ones,  namely, directly 
  80. under   each  city   code.  Hit   one  or   more  of   these  to 
  81. select/deselect the  cities you want  to try.  But  don't select 
  82. any for  which you've not defined  any BBS's in an  *.0 file. In 
  83. version  1.00, this  causes  Am_Nix to  exit to  the CLI,  while 
  84. leaving  you connected  to  the remote  outdial.   After  you've 
  85. selected all  the cities  that you want  to try, hit  the "start 
  86. dialing" gadget.   A CITY status  window will be  opened to keep 
  87. you up  to date on the  progress of this session.  If you select 
  88. "Network Monitor" before you  "start dialing", you'll be able to 
  89. watch  the  actual dialogue  going  on  between  Am_Nix and  the 
  90. network  in a  special  "Network Monitor"  Window. The  "Network 
  91. Monitor" gadget  is a toggle; if  you hit it  again the "Network 
  92. Monitor" window will be  closed.  The two gadgets marked "Serial 
  93. Port  12/24"  and "Connect  String  12/24"  behave  in the  same 
  94. manner.   These  two  gadgets  toggle the  serial  port and  the 
  95. connect  string  sent  to  PCP,  between  1200  and  2400  baud, 
  96. respectively.  It should be noted that when they are set for the 
  97. higher rate,  the center  of the gadget  will be filled  with an 
  98. orange  dot.  When  a   city  connects  you'll  get  an  audible 
  99. notification  and will  be presented  with a  BBS list  for that 
  100. city.  Select  one or more BBS's by  hitting the select/deselect 
  101. gadgets  directly  behind the  phone  numbers.  Then hit  "start 
  102. dialing" again. This time a BBS status window will be opened and 
  103. Am_Nix will make repeated attempts to connect with the BBS's you 
  104. have selected.   When a BBS  connects, you get  the same audible 
  105. warning as  with CITY connect and  Am_Nix will exit  to the CLI.  
  106. Bring up your favorite terminal program and start communicating.
  107.  
  108.     The select  gadgets in the BBS selection window currently do 
  109. not occupy  the entire phone number (they're  leftovers from the 
  110. CITY selection window) so hit 'em on the left side in the prefix 
  111. portion.   Both the BBS dial  and CITY dial  loops are abortable 
  112. (hit  the abort gadget).     If you  abort a  BBS loop,  you can 
  113. either  select new  BBS's in  the same  city or  hit "Disconnect 
  114. City"  which  will  take  you  back  to the  CITY  window  after 
  115. disconnecting from  the current  city.   At this point,  you can 
  116. select new  cities to try or  exit the program  by selecting the 
  117. system close gadget.   However, you'll still be connected to the 
  118. pad at the @ prompt.
  119.  
  120.        The biggest  warning right now  is in the  BBS definition 
  121. files.   Each BBS entry MUST  be the correct  length, don't take 
  122. out any of the  stuff     00/00/00   00:00,      etc. There must 
  123. be a  line separator  (hex 0A) after  each line except  the last 
  124. one.  The standard  Amiga editor  works fine  to maintain  these 
  125. files.  Use  AZPHO.0  as  a  template.  Another  point  is  that 
  126. currently you can't mix 1200/2400 baud cities in the CITY queue. 
  127. In other words, if you  set the "connect string" gadget for 2400 
  128. (it's highlighted), be sure to select only cities with 2400 baud 
  129. available. Also make sure  that the "serial port" gadget matches 
  130. the baud rate that you were set to when you connected to the pad 
  131. with your terminal program.  At the end of each BBS entry in the 
  132. *.0 files  are five  "AT" signs (@@@@@).   The first  one should 
  133. ALWAYS be @.   The second one can be an @ or  1.  The last three 
  134. may  be @@@  or an  area-code.   Use these  last four  "AT" sign 
  135. positions to dial BBS numbers  that are not local to the outdial 
  136. rotary locations.   For example, for a prefix  of 618- you would 
  137. set these  positions to  @@618 while  for 1-415- you  would make 
  138. them @1415 ...
  139.  
  140.       Comments, suggested improvements,  bug-reports, etc can be 
  141. sent to  me via the Net Exchange  on PCP or at one  of the BBS's 
  142. listed below.  I have quite  a few improvements/new  features in 
  143. mind for Am_Nix. Here are a few, listed by order of importance:
  144.  
  145.           
  146.           Improved dialogue routines  that do the actual 
  147.           conversation  with  the   network.  Right  now 
  148.           Am_Nix will  occasionally become  confused and 
  149.           "out of  sync" with  the network.   While this 
  150.           has  been infrequent  during BETA  testing, it 
  151.           has  happened  once or  twice.  Unfortunately, 
  152.           when  it  does,  there  is no  easy  way  out. 
  153.           Because of the nature  of this item it will be 
  154.           the top  priority. In  fact, this  item should 
  155.           easily be  remedied within the next  few days, 
  156.           so   that  by   the   time   I  recieve   your 
  157.           registration fee,  I'll be  ready to  ship the 
  158.           improved version(1.01).
  159.           
  160.           
  161.           A  smoother interface  between Am_Nix  and the 
  162.           user's  terminal  program.   In  other  words, 
  163.           moving from the terminal program to Am_Nix and 
  164.           back again. The  ultimate solution for this is 
  165.           to have Am_Nix multitask right along with your 
  166.           favorite terminal program.  However, this will 
  167.           mean that  both programs must open  the serial 
  168.           port  in the  SHARED mode.  Unfortunately, not 
  169.           all terminal  programs currently do  this. I'm 
  170.           open to suggestions  from any of you technical 
  171.           gurus out  there who may  be taking a  look at 
  172.           Am_Nix.
  173.           
  174.           
  175.           A  VERY dumb  terminal mode  so that  when you 
  176.           connect to  a BBS you can  *immediately* begin 
  177.           talking  and  not  miss  any  of  the  opening 
  178.           banner,  etc.   This  feature   should  become 
  179.           unnecessary,  however,   if  I  can   get  the 
  180.           multitasking feature to  work correctly.  (See 
  181.           above).
  182.           
  183.           
  184.           A  'prettier'   interface,  perhaps   lots  of 
  185.           colors.   Since that takes more  memory, it'll 
  186.           be a user  option. Version 1.01 when released, 
  187.           should  have some  sample screens  included to 
  188.           illustrate what I'm talking about.
  189.           
  190.           
  191.           Internal   maintenance  (additions,   changes, 
  192.           deletions)  of   the  *.0,   amnix.cities  and 
  193.           amnix.config files. Throw away that editor!!!
  194.           
  195.           
  196.           Support for PCP Direct Connects  (DAFS)
  197.           
  198.           
  199.           Support for more than one BBS file for a city. 
  200.           That's the reason for the .0 suffix. I plan to 
  201.           have up  to 10  (*.0 thru  *.9) BBS  files for 
  202.           each city.   Currently,  you're limited  to 50 
  203.           BBS's per  city (and  also 50 cities,  but the 
  204.           way  PCP  moves ahead  that  should  not be  a 
  205.           problem for a while).  8-)
  206.           
  207.           
  208.           Automatic logins to the BBS's.
  209.           
  210.           
  211.           The "I have made a connection" message will be 
  212.           improved to announce  the actual City/BBS name 
  213.           to which you've connected.
  214.           
  215.           
  216.           User statistics  that will  show the  date and 
  217.           time of last connection  to each CITY and also 
  218.           each BBS. Also,  the number of attempts before 
  219.           connection during the  most recent session and 
  220.           an average for all previous sessions.
  221.  
  222.           
  223.           WorkBench Operation.
  224.           
  225.           
  226.           Better support for multiple baud rates.
  227.           
  228.           
  229.           Plus any  other neat  idea that I  (or anybody 
  230.           else) might think of.
  231.  
  232.  
  233.     A  few final thoughts...   I  have *MANY* hours  invested in 
  234. Am_Nix.   In fact,  it has  virtually consumed every  spare hour 
  235. I've had  for the last  two months.   While it will  most likely 
  236. never  be a  commercial program,  neither is  it Public  Domain. 
  237. Therefore,     I  am  classifying   it  as  ShareWare.     After 
  238. considerable  discussion with  several other  ShareWare authors, 
  239. I've decided that if I'm  to receive compensation for my work, I 
  240. can *not* release  a fully functioning version of  Am_Nix to the 
  241. BBS's and Networks.   Therefore, this version will only dial the 
  242. following  cities: AZPHO,  ILCHI  and NYNYO.  To  the many  fine 
  243. upstanding Amiga users who  would have sent the registration fee 
  244. anyway,  my humble  apologies  for the  inconvenience that  this 
  245. action  will cause.   To  those who  would just  use it  free...  
  246. Well, what can I say???
  247.  
  248.       Until  December  31, 1988,  the registration  fee is  only 
  249. $15.00.   After that time, it  will increase to  $25.00.  Anyone 
  250. who places  an order  for Am_Nix at  this reduced price  will be 
  251. entitled to  the next  major release  (2.00) free.   All  of the 
  252. items outlined  above will be  included in the the  2.0 release.  
  253. If everything  goes according to  plan, the 2.0 version  will be 
  254. available around the end of the year.
  255.  
  256. To order  Am_Nix, send  a check  or money order  (preferably the 
  257. latter) for $15.00, along with a 3.5 inch floppy diskette to:
  258.  
  259.               Magna Systems
  260.               P.O. Box 2426
  261.               Orange Park, FL   32073
  262.  
  263. If  you send  a  money  order, a  fully  functioning version  of 
  264. Am_Nix, personalized  with your name in the  opening window will 
  265. be mailed to you the same day.  Personal checks will be held for 
  266. 3 to 5 days, depending upon your location.  For those who have a 
  267. People Link account, include your PLINK User ID and I will EMail 
  268. your copy of Am_Nix to you.
  269.  
  270.      For purposes of answering questions, receiving bug reports, 
  271. etc, I  usually try  to check  into the Net  Exchange on  PCP at 
  272. least once a day.  I also check in regularly on:
  273.  
  274.        Amiga DOC    ILCHI       351-8815
  275.        BBS-1984     ILCHI       484-1984
  276.        AmiHolics    AZPHO       843-8486
  277.  
  278. My User ID at all four of these locations is Bill Fischer.
  279.  
  280. As a final  thought, I'd like to mention a  couple of people who 
  281. have been my capable  BETA testers during this project. They are 
  282. Harv Laser, Christopher Bailey  and last, but certainly far from 
  283. least,   Bob  Uhrick.      Their  help   has  been   invaluable. 
  284. Additionally, Bob  is just  putting the  finishing touches  on a 
  285. program  called Am_Convert.  Am_Convert will  read Captain  Chet 
  286. Solace's "The Final  List" and select only those  BBS's that are 
  287. PC-Pursuitable. It  then writes  the CITY.0  files for  input to 
  288. Am_Nix. Presto... trouble-free use of PC-Pursuit for your Amiga.  
  289. While Am_Nix is  a super program, it's made  even better by this 
  290. nifty  little  'add on'  program.  *PLEASE*  consider mailing  a 
  291. donation to Bob Uhrick for his efforts. And from Bill Fischer... 
  292. Thanks, Bob.
  293.